package com.ilink.groundservice.service.Skill;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.ilink.groundservice.entity.VO.AiX.AiXSkillTreeResponse;
import com.ilink.ilinkapi.dto.ground.AiX.AiXSkillTreeFilterRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXSkillTreeInsertRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXSkillTreeUpdateRequest;
import com.ilink.ilinkapi.dto.ground.AiX.AiXSkillProgressUpdateRequest;
import org.springframework.web.multipart.MultipartFile;

import java.util.List;

public interface AiXSkillTreeService {

    /**
     * 分页查询技能树列表
     */
    IPage<AiXSkillTreeResponse> getSkillTreeList(AiXSkillTreeFilterRequest request);

    /**
     * 根据ID获取技能树详情
     */
    AiXSkillTreeResponse getSkillTreeById(Long skillTreeId);

    /**
     * 根据ID和用户ID获取技能树详情（含进度）
     */
    AiXSkillTreeResponse getSkillTreeByIdWithProgress(Long skillTreeId, String userId);

    /**
     * 插入技能树
     */
    Long insertSkillTree(AiXSkillTreeInsertRequest request);

    /**
     * 更新技能树
     */
    void updateSkillTree(AiXSkillTreeUpdateRequest request);

    /**
     * 删除技能树
     */
    void deleteSkillTree(Long skillTreeId);

    /**
     * 更新技能树封面
     */
    void updateSkillTreeCover(MultipartFile file, Long skillTreeId);

    /**
     * 获取用户的技能树进度
     */
    AiXSkillTreeResponse getUserSkillTreeProgress(Long skillTreeId, String userId);

    /**
     * 更新用户技能进度
     */
    void updateUserSkillProgress(AiXSkillProgressUpdateRequest request, String userId);

    /**
     * 重置用户技能进度
     */
    void resetUserSkillProgress(Long skillTreeId, String userId);

    /**
     * 获取热门技能树
     */
    List<AiXSkillTreeResponse> getPopularSkillTrees(Integer limit);

    /**
     * 获取用户的技能树列表
     */
    List<AiXSkillTreeResponse> getUserSkillTrees(String userId, Long areaId);

    /**
     * 获取技能树最常用的8个标签
     */
    List<String> getSkillTreeTags(Long areaId);

    /**
     * 获取技能树标签（替代分类）
     */
    List<String> getAllSkillTreeTags(Long areaId);
} 